home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software Vault: The Gold Collection
/
Software Vault - The Gold Collection (American Databankers) (1993).ISO
/
cdr05
/
win210.zip
/
READ.ME
< prev
next >
Wrap
Text File
|
1993-06-08
|
8KB
|
179 lines
FILE NAME..: READ.ME
TOPIC......: XGA/DMQS Display Information File Installation Program &
DMQS (Display Mode Query/Set) Profile Services.
I. XGA/DMQS Display Information File Install Tool User's Guide
A. Purpose of Tool
The purpose of the XGA Display Information File Installation tool
is to install display information files onto a computer system
that supports DMQS and will be running an XGA graphics application
that will be using the DMQS support services to initialize the
XGA Adapter/Display hardware environment.
Below are the steps involved with running the installation tool
as well as a description of how the data that is installed by the
installation is used by other applications:
1. Unpacking/Copying DGS files.
The XGA installation tool allows one to either unpack all display
files from a supplied packed file OR to copy a specific set of
display files.
If a packed file is provided, then this packed file will be
unpacked into individual display files of the name MONxxxx.DGS,
where xxxx is display ID value for the display that the file
corresponds to.
If individual display files are to be installed, then the
installation tool will scan the supplied disk for all files
matching the file template MON*.DGS and then copy them to
the specified installation sub-directory.
2. Updating DOS and OS/2 system boot files.
In addition to installing the display files, the installation
toll will also update the system boot files on the user's
system hard-disk.
The DMQS services must have a system environment variable defined
in order to tell it where to look for the display information files
it needs to initialize the XGA Adapter/Display properly. The
setting of this environment variable must be done within the
system boot file. Thus, the installation tool will automatically
update the system file(s) found in the root directory of the
start up hard-disk in order to properly set the environment to
point to the installation directory specified during installation.
3. What are the MONxxxx.DGS files used for?
The DGS files in the file name form of MONxxxx.DGS will be used
by the DMQS system services in order to initialize the XGA Adapter/
Display configuration properly. Without the DGS file, the DMQS
services would not be able to determine what type of display is
attached to the system and what display capabilities the display
has.
B. Starting the XGA DIF Install Tool
1. Install Tool requirements.
a. Display Information File Install tool files:
- READ.ME (This information file)
- DIFINST.EXE (Install tool program)
- INSTHELP.GML (Help panel file used by DIFINST.EXE)
- STARTUP.GML (Menu file used by DIFINST.EXE)
- DIFINST.GML (Menu file used by DIFINST.EXE)
- 8FDAM.DGS (Packed XGA Display Information File)
b. Starting the XGA Display Information File Install Tool.
To start the XGA DIF Install tool select the "Install XGA DMQS
Display Information File(s)" option from the DOS Installation
Program for the XGA Device Driver main menu.
2. Obtaining help in using the installation tool.
The XGA Display Information File Installation tool has on-line help
services whereby one can depress the F1 key in order to get help.
The type of help provided is as follows:
a. General Help Support.
A set of help panels are provided that will describe the
general aspects of the XGA DIF Installation tool such as
how the tool can be used, special keyboard key definitions,
etc.
b. Field level help support.
Specific field level help is provided whereby one can
position the cursor on a specific input field and then
depress the F1 key to obtain help on that specific field
(i.e. What kind of input is expected for the input field).
II. XGA/DMQS Display Information File Profile Services.
The DMQS profile services found in the DMQS system services will allow
one to customize the XGA Adapter/Display environment found on a computer
system.
A. How to create an XGA Display Configuration Profile:
When you first install the XGA Display Information Files on your
system, no profile will be created and the XGA Graphics program that
uses the DMQS services will be provided with the default POST startup
DMQS values. However, you can override some of the DMQS values via
the XGA Display Configuration Profile mechanism.
The XGA/DMQS Display Information File Install Tool has an option on
the main menu that allows you to create the DMQS Profile. This option
is entitled "Change XGA Display Configuration Profile". There is
on-line help provided to describe what you need to do to create this
profile.
B. How the DMQS profile services work:
The DMQS profile services will look for a file by the name of
XGASETUP.PRO found in the same directory that has the Display
Information Files (MONxxxx.DGS).
This file is a ASCII text file which contains a set of GML tags that
will be used to provide information to the DMQS system services about
the XGA Adapter/Display environment. This profile allows one to
override some attributes of how the XGA hardware will be initialized
and used by graphics applications which use the DMQS system services.
C. Syntax and content of XGASETUP.PRO:
The file XGASETUP.PRO will be found in the same directory as the
Display Information Files which are installed by the XGA Display
Information File Installation Tool (the default path is XGA$DMQS).
This ASCII text file will contain a set of tags which define
attributes of the XGA Adapter/Display hardware installed.
Below is an example XGASETUP.PRO profile:
/**********************************************************************
/*
/* FILENAME: XGASETUP.PRO
/*
/* DESCRIPTION: Profile to set XGA DMQS preferences on current system.
/*
/* LAST MODIFIED: 03/29/92 at 10:57:37
/*
/**********************************************************************
/**********************************************************************
<SLOT, NUMBER=5, MONITOR_ID=00F0>IBM 8514
/**********************************************************************
<SLOT, NUMBER=8, MONITOR_ID=F0FF>IBM 8515, 8516
/**********************************************************************
<STARTUP, NUMBER=5>
The profile above does the following:
────────────────────────────────────
> Informs the DMQS services that the display in slot 5 is a display
of type 00F0 and that DMQS should use the display file MON00F0.DGS
to obtain information about the installed display.
> Informs the DMQS services that the display in slot 8 is a display
of type F0FF and that DMQS should use the display file MONF0FF.DGS
to obtain information about the installed display.
> Informs the DMQS services that when any XGA graphics application
uses DMQS services that the application will display its graphics
output on the XGA adapter card in slot 5.
NOTE: If any of the slot numbers and/or display IDs are invalid when
read in by the DMQS profile services, then the tag will be
ignored and it shall not have any affect on how the DMQS services
initializes the XGA hardware.
<END OF DOCUMENT>